home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / xeno / bbbbscd.lha / BBBBScd / readme.install < prev    next >
Text File  |  1995-03-17  |  13KB  |  346 lines
  1. BBBBS/Xeno CD Door V1.00 (First General Release / Hatched to XENOL 18/3/95)
  2. ---------------------------------------------------------------------------
  3.  
  4. This is V1.00 of BBBBScd, a CD door for Xenolink 1.90+
  5.  
  6. This distribution is also an update to V0.90 Beta.
  7.  
  8.  
  9.  
  10. Changes & Enhancements:
  11. -----------------------
  12. * Made all the scripts read XCONFIG:BBBBScd.config for sysop configurability
  13. * Added LZX/LHA choice for user. (See warning re: LZX and CDROM filesystems)
  14.  
  15.  
  16.  
  17. Requirements:
  18. -------------
  19. * This utility was written & tested on Kickstart 3.0, on an A4000/40.
  20.   The rexx support libraries are compatible with the above configuration.
  21.   As for older/newer kickstarts... it's up to you to check first.
  22. * Xenolink Professional BBS V1.90+
  23. * LHA and LZX somewhere in your Amiga's command PATH
  24.  
  25.  
  26.  
  27. Installation:
  28. -------------
  29.  
  30. 1. Basically, you should already have unpacked this archive to your doors:
  31.    assign, and should be reading this text file from doors:bbbbscd/
  32.  
  33.    *NB* The user archives and temporary Email will be written to sub-dirs
  34.         of Doors:BBBBScd/, but this is configurable by you after installation
  35.  
  36.  
  37. 2. COPY DOORS:BBBBScd/SYSTEM/ SYS: ALL CLONE
  38.    - This will install the rexx scripts, rexx support libs, and the PD
  39.      utilities "Newlist" and "RunBack" to your system boot partition.
  40.  
  41. *WARNING* - if you still run kickstart 1.x...
  42.    - check the versions of the 2 included libraries if you already have them
  43.      in your system partition. Those supplied SHOULD work on OS2.x or OS3.x,
  44.      and NOBODY is using 1.3 nowadays anyway, are they?
  45.  
  46.  
  47. 3. COPY DOORS:BBBBScd/XENOLINK/ XENOLINK: ALL CLONE
  48.    - installs the menus and menutext for you.
  49.    - installs the default xconfig:BBBBScd.config for you.
  50.    - also installs 'Junkmail' V1.90 (c) Alan Bond in Xenolink:utilties
  51.      - you may miss this out if you already have it (or a newer version)
  52.  
  53.  
  54. 4. Compile CDbbbbs.src and add a CALLMENU "CDbbbbs.menu" statement somewhere
  55.    in your own menus.
  56.    To compile the provided menu, type  MENU CDbbbbs.src
  57.  
  58.  
  59. XCONFIG:BBBBScd.config
  60. ----------------------
  61. You should now be ready to rock 'n' roll... using the default settings, but
  62. here's the current config options available in xconfig:BBBBScd.config...
  63.  
  64. <-- snip -->
  65. Doors:bbbbsCD/
  66. CD0: CD1: CD2: CD50: CD51: CD52: CD53: CD54: CD55: CD56:
  67. 224
  68. 0
  69. Teri Odin CD
  70. 5000000
  71. 4000000
  72. Y
  73.  
  74. ****************************************************************************
  75. *               Xenolink BBBBScd door, Configuration file                  *
  76. ****************************************************************************
  77. Line 1: Path to BBBBScd/ dir where file archives & temp email will be stored
  78. Line 1: List of ADOS devices or Assigns which will be used by BBBBScd door
  79. Line 3: Minimum user level to allow Writing of New CD Caches on large dirs
  80. Line 4: Xenolink Message base # to be used to email user with file attach
  81.         *MUST* be a 'local' msgbase (not netmail) and must allow PRIVATE msg
  82. Line 5: The FROM: 'name' of the CD Door, as appearing in msg header (Your BBS?)
  83. Line 6: The largest recursive SELECT ALL bytes total allowed in one select
  84. Line 7: The total output archive(s) size allowed. Archiving will stop after
  85.         this amount of data has been file attached to the user.
  86. Line 8: LZX option (Y)es or (N)o - LZX1.00 won't archive with some CDROM
  87.         Filesystems
  88. ****************************************************************************
  89.  
  90. <-- snip -->
  91.  
  92.  
  93.  
  94. Other Considerations:
  95. ---------------------
  96.  
  97. 1. It is assumed that LHA and LZX are somewhere in your workbench command 
  98.    path, and neither are included with this archive
  99.  
  100. 2. As menioned in the lso, script bbsArcExt.rexx has a parameter to set the
  101.    msgbase number consig file, the selected msgbase must currently be a LOCAL
  102.    (non echomail) msgbase valid for your BBS, and it must also allow PRIVATE
  103.    mail. 
  104.    - If you change the msgbase from the default of #0, you will need to edit
  105.      and recompile CDbbbbs.src menu to use your selected msgbase instead.
  106.  
  107. 5. ***WARNING*** 
  108.    - After installing & using this door, my NewUser.Rexx script !!!STOPPED!!! 
  109.      !WORKING!  ;(
  110.  
  111.    - I think it is something to do with the rexxarp.library, but haven't 
  112.      tracked it down yet.
  113.    - You can 'fix' your BBS newuser.rexx script by putting the following
  114.      statements into your newuser.rexx script, immediately after the 
  115.      "PARSE ARG name." line near the beginning...
  116.  
  117. <-- snip -->
  118.  /* Open the support library if it is not already open. */
  119.  if ~show('L',"rexxsupport.library") THEN
  120.    DO
  121.     addlib('rexxsupport.library',0,-30,0)
  122.    END
  123.  if ~show('L',"rexxmathlib.library") THEN
  124.    DO
  125.     addlib('rexxmathlib.library',0,-30,0)
  126.    END
  127. PRINT ' '
  128.  if ~show('L',"rexxarplib.library") THEN
  129.    DO
  130.     addlib('rexxarplib.library',0,-30,0)
  131.    END
  132. <-- snip -->
  133.  
  134.    - Inserting the above statements should sort out any problems you
  135.      might have with other rexx scipts, but I'd appreciate feedback on
  136.      this problem for a more elegant & permanent solution, please! ;)
  137.  
  138.  
  139.  
  140. ***WARNING*** Possible LZX archiving problem with some CDFILESYSTEMS
  141. --------------------------------------------------------------------
  142. On Teri Odin, I use the AsimCDFS CDROM filesystem, and LZX archives
  143. end up with CRC checksum errors where files are addes from CD drives
  144. using the above mentioned CDFS.
  145.  
  146. I have tested it out on 2 SCSI controllers, and both exhibited the
  147. same problem. 
  148.  
  149. Tests of LZX archiving from one hard disk to another were 100% Successfull!
  150.  
  151. I will look further into this problem to try and find a solution, but
  152. a special option has been added to the XCONFIG:BBBBScd.config so that you
  153. can prevent the user from being offered the LZX packing option if your
  154. system suffers the same probs. ;)
  155.  
  156. To find out if your CD Filesystem is affected, try archiving a file from
  157. one of your cd drives and then runthe LZX t (test) option on the archgive.
  158.  
  159. <-- snip --> (example used: Aminet 5 CDROM)
  160. 16.Ram Disk:> list aminet5:index
  161. Directory "aminet5:" on Friday 17-Mar-95
  162. index                      16898 ----rwed 17-Feb-95 16:51:57
  163. 1 file - 10 blocks used
  164.  
  165. 16.Ram Disk:> 
  166. lzx a ram:test aminet5:index
  167.  
  168. LZX 1.00 (Evaluation) Archive/Extract utility - 68040/68060 Version
  169. Copyright © 1995 Data Compression Technologies.  All rights reserved.
  170. Commercial use of this unregistered program is prohibited
  171.  
  172. Creating new archive 'ram:test.LZX':
  173.  
  174.   Adding (      15)  aminet5:index %00   
  175.   ** 1 file(s) added
  176.  
  177. 16.Ram Disk:> lzx t ram:test
  178.  
  179. LZX 1.00 (Evaluation) Archive/Extract utility - 68040/68060 Version
  180. Copyright © 1995 Data Compression Technologies.  All rights reserved.
  181. Commercial use of this unregistered program is prohibited
  182.  
  183. Testing archive 'ram:test.LZX':
  184.   (       0 /       15) index  (      15) ** BAD CRC (wanted F18B242F got A2A244D
  185. B): index
  186.  
  187.   ** 1 file(s) tested,  1 file(s) BAD ]
  188.  
  189. <-- snip -->
  190.  
  191. If you see the BAD CRC message above, then you need to disable LZX archiving
  192. until a later release of BBBBScd, when the problem will hopefully be solved.
  193.  
  194.  
  195.  
  196.  
  197. Extra SHELL door:
  198. -----------------
  199. As an extra, I have provided a SHELL/CLI version of the bbsExtDl rexx script,
  200. which you can use 'offline' to Cache new CD's, or even as a Multiple 
  201. 'File Attach' utility to send file(s) to your users.
  202.  
  203. Option 1: (File attach some CDROM files to a user)
  204. --------- 
  205. Open a shell and type  rx s:bbsExtDl.SHELL User_Name
  206.  
  207. (User_name is the user you wish to receive the files)
  208.  
  209.  
  210. Option 2: (Cache a new CDROM).
  211. ---------
  212. As above, but you don't need the username. 
  213.  
  214. Currently, you have to select each dir one by one, (what a slog!) but I'm
  215. working on an automated version which will cache a whole CDROM... Soon! ;)
  216.  
  217. Any directory containing more than 25 files or sub-dirs will offer you the
  218. option to Pre-Cache the directory, so that when the users browse this CD
  219. online, they get almost instantaneous filelists! This overcomes the slow
  220. nature of an Arexx door such as this one.
  221.  
  222.  
  223. Option 3: (Send *ANY* file(s) to a user from shell)
  224. --------
  225.  
  226. Open a SHELL and type  rx s:ArcExt.rexx User_Name node archiver file file/*
  227.  
  228.  
  229. The above command uses parameters as follows...
  230.  
  231. User_Name   = The user who will receive the file(s). Replace spaces with "_"
  232. Node        = Always '0' from the SHELL
  233. archiver    = X for LZX or H for LHA
  234. file,file/* = The filename(s), including full path. As many as you like, just
  235.               seperate each one with a space. (You can't archive single files
  236.               which have a space within the filename!)
  237.               You may also do a recursive file/sub-dir archive by entering
  238.               a full path, ending with "/*" e.g. AMINET5:AMINET/COMM/*
  239.  
  240.  
  241.  
  242.  
  243.  
  244. Finally, here's my recent echomail announcement about the door, from 
  245. Xeno_Utils echo, in case you missed it... ;)
  246.  
  247.  
  248. *** Area: NET_2_259_75_1                          Date: 11 Mar 95 23:32:45
  249. *** From: Derek Scott (2:259/75.1)
  250. *** To  : Derek Scott (2:259/75.0)
  251. *** Subj: BBBBS/Xeno CD Door
  252.  
  253.  * This message forwarded from area 'XENOLINK_UTIL' (XENOLINK_UTIL)
  254.  * Original message dated 11 Mar 95, from Derek Scott
  255.  
  256. BBBBS CD Door converted to Xenolink
  257. -----------------------------------
  258.  
  259. Is there room in the Xenolink sysop community for (YET) another CD door?
  260.  
  261. I have just converted Richard Lee Stockton's Arexx CD door to run under 
  262. Xenolink, and would be happy to 'hatch' it *if* its features have something
  263. not already available to Xenolink sysops.
  264.  
  265. Features List
  266. -------------
  267. * Presents user with 'SHELL' type dispay, and allows uses to move freely
  268.   within the tree path of any CD or valid ADOS device/assign. All devices
  269.   are treated as READ ONLY and are sysop configurable, thus users only have
  270.   access to areas you define (i.e. parts of your h-d)
  271. * CD_Exclude file holds list of files which door should not display to user.
  272.   - corrupt files, virus infected CD files, copyright files, X-Rated files? 
  273. * User may READ text files, view archives contents etc.
  274. * Can select individual files from multiple devices in one session.
  275. * Can SELECT ALL files (plus any & all sub dirs) from current directory.
  276. * Pre-caches large directories to h-d to greatly increase display speed.
  277.   - Pre cache writing is only available to users with sysop defined level
  278.     or higher.
  279. * All selected files are archived together - as a background task - and 
  280.   sent as a file attach to the user in sysop definable msgbase.
  281.   - If user logs out it will be ready & waiting when they next log in.
  282.   - Self deleting upon successful download
  283.   - Currently uses LHA archiving. (LZX also available, but with restrictions)
  284. * Sysop definable MAX_SIZE on both recursive directory/file selection and
  285.   on output archive size.
  286. * Online HELP page
  287. * Archiver script can be run seperately from shell/cli to send file(s) to 
  288.   user as attached file/msg, including recursive directory archiving.
  289. * Will happily use ADOS 'Assigns' as well as devices
  290.   - Useful for PC CD's with illegal ADOS volume names like D::
  291.   - Can be persuaded to 'rename' above CD so user only sees assigned name.  
  292.  
  293.  
  294. Future Features
  295. ---------------
  296. * User selectable archiving filetype. 
  297.   - LZX available from V1.00, but see docs for details of CDFS / LZX probs
  298.   - Support to use all your current xconfig:archivers.config entries
  299. * Auto detection and support of 'Point' users off your BBS.
  300.   - Use Xfidonet:pointlist.123 and systems.config to detect point user
  301.     and preferred archiving method
  302.   - send archive & msg direct to point in xout:
  303. * Anything else within reason <G>
  304.  
  305.  
  306.  
  307. Background
  308. ----------
  309. I ran a BBBBS board for almost a year, and the CD door was popular, as it 
  310. is easy to use, 'learns' new CD's by pre-caching large directories to h-d,
  311. and *best* of all, it bundles collections of files and archives them into
  312. a few d/l archive packets. 
  313.  
  314. I spend some time rewriting the recursive SELECT ALL function for 2 reasons:
  315.  
  316. 1. Limit max size to a sysop-definable amount of bytes (on input to
  317.    archiver)
  318. 2. Cope with bundling filenames even if they contain spaces (only on
  319.    recursive SELECT ALL - still won't use single files with spaces)
  320.  
  321. I also added multi-line support by adding node numbers to all filenames and
  322. data-structures used by the 2 scripts.
  323.  
  324.  
  325.  
  326. Requirements
  327. ------------
  328. * Requires ADOS 2.x or above, and (obviously) AREXX.
  329. * Requires rexxarp.library and rexxmath.library (Supplied)
  330. * Requires QUICKSORT, NEWLIST and RUNBACK commands (supplied)
  331. * Requires LHA, LZX (and any future supported archivers) in your command path
  332.  
  333. * Uses NewList (C= 'List' replacement) to recursively size SELECT ALL files
  334. * Uses Junkmail, (c) Alan Bond to handle the msg upload & file attach(s).  
  335.  
  336.  
  337. Feel free to pop online to Teri Odin (if you're in the UK) on node 1 
  338. 01450-373323 and try it out first to see what you think.  ;)
  339.  
  340.  
  341. Regards,
  342.                              _                               _
  343. Derek Scott,              _ //   AMIGA - To boldly go     _ //
  344. Sysop, Teri Odin BBS      \X/ where no PC has gone before \X/
  345.  
  346.